home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / editors / sprite / sprite.doc < prev    next >
Text File  |  1989-11-02  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    Sprite Maker
  8.  
  9.                 Rev. 2.01
  10.  
  11.  
  12.              copyright 1989 by Billy Dalrymple
  13.  
  14.                    ------------
  15.  
  16.  
  17.  
  18.                   Billy Dalrymple
  19.                   5219-G Penrith Dr.
  20.                   Durham N.C.  27713
  21.  
  22.                      OR
  23.  
  24.                   Leave Message on
  25.  
  26.                  GENEAL BOARD
  27.                  919-471-6026
  28.  
  29.  
  30.           Donations and/or Comments are Greatly Appreciated !
  31.  
  32.  
  33.       Special Thanks to Brook Monroe for his Technical Assistance !
  34.  
  35.  
  36. ****************************************************************************
  37.  
  38.  
  39.     What Is Sprite Maker ?
  40.  
  41.      Sprite Maker Rev 2.01 is a tool for EGA programmers which allows
  42.      the programmer to easily create, manipulate, and save EGA images
  43.      for use with many block manipulation functions such as putimage,
  44.      and moveblock.  Sprites created with Sprite Maker can vary in
  45.      size from 1*1 pixels to 100*60 pixels.
  46.  
  47.      Sprite Maker can be used as a paint program for people who doodle,
  48.      and just want to draw.  However,  I designed Sprite Maker specifically
  49.      for creating EGA / VGA sprites to be used in other programs.  In
  50.      addition to the sprite being created, a mask is also created which
  51.      can be used to enhance the display of the sprite. ( More info
  52.      available by request )
  53.  
  54.      Sprite Maker displays sprites in two formats.  1) the actual
  55.      sprite image (on the right hand side of screen) and 2) an edit image
  56.      which is displayed beneath the color palette.  The actual sprite image
  57.      is the actual representation of the sprite, ie: how the sprite will
  58.      actually look if used in other applications.  The edit image is
  59.      where editing will be done.  This image is automatically adjusted
  60.      to the maximum possible size for a given sprite size. ie: pixel
  61.      representations in the edit image will be considerably larger
  62.      for a 5*5 sprite than for a 80*50 sprite.
  63.  
  64.  
  65.  
  66. ****************************************************************************
  67.  
  68.      Sprite Maker 2.01 supports a mouse, and has several added
  69.      data manipulation features.
  70.  
  71.      This program was written in Turbo C (tm) and is designed for
  72.      EGA/VGA Graphics systems.  Resolution is 640*350 for EGA or
  73.      640*480 for VGA (both at 16 colors).
  74.  
  75.      Hardware requirements are 512k ram, EGA or VGA graphics, Microsoft(tm)
  76.      compatable Mouse, and IBM compatability.
  77.  
  78.      I hope that you find this program useful to your work, play,
  79.      or hobby.  Feel Free to Distribute this software package AS IS
  80.      and without alteration, according to the following standards.
  81.  
  82.            1)  That no one receive any compensation from this
  83.            program package in any way. (without
  84.            my written consent)
  85.  
  86.            2)  Should you find this software to be helpful
  87.            to you,  please write and tell me so. (I could
  88.            use it to justify my computer time to my wife.)
  89.  
  90.            3)  If you find any bugs that I should be aware
  91.            of, or improvements which you feel would be
  92.            benificial to you, Please notify me of them.
  93.  
  94.            4)  This software package should not be archived by
  95.            any other name than SPRITE21, and should contain
  96.            the following files:
  97.  
  98.               Sprite21.exe  - Sprite Maker rev 2.01
  99.                      executable file
  100.  
  101.               Readme.doc   - This file
  102.  
  103.               Exit.dat     - Icon data files
  104.               Load.dat
  105.               Save.dat
  106.               New.dat
  107.               Fill.dat
  108.               Flip.dat
  109.               Flop.dat
  110.               Rot.dat
  111.               Brdr.dat
  112.               Line.dat
  113.               Crcl.dat
  114.               Rect.dat
  115.  
  116.            Should you find any discrephancies in this archive
  117.            Please notify me immediatly.
  118.  
  119.            5)  And last but not least, should you find
  120.            this software extremely helpful to your
  121.            programming,  donations are greatly appreciated.
  122.            However, I require no registration fee.  If
  123.            you are having difficulty with the program
  124.            or just have comments, feel free to express
  125.            them without feeling obliged to pay a registration
  126.            fee.
  127.  
  128.      Please include the following information when contacting me:
  129.  
  130.          -  Name, Address, age
  131.          -  Where you aquired my program
  132.             ie: BBS name, number, State
  133.             or Shareware Distributor name
  134.          -  Why are you using it ?
  135.  
  136. *****************************************************************************
  137.  
  138.  
  139.     SPRITE MAKER 2.01 INSTRUCTIONS:
  140.  
  141.  
  142.     EXECUTION:
  143.  
  144.      To execute Sprite Maker 2.01 , type Sprite21 from DOS.  After the
  145.     title screen has been displayed, you will see a screen divided into four
  146.     sections.
  147.  
  148.  
  149.     SCREEN FORMAT:
  150.  
  151.      The top section will contain 12 icons.  These are the
  152.     command icons which you can click on to give Sprite Maker your commands.
  153.     These commands will be discussed later.  Beneath the icons, you will
  154.     see the color palette consisting of 16 colors to choose from.  To the
  155.     right of the palette, you will see a block showing the current
  156.     selected color.
  157.  
  158.      The screen section which is below and to the right of the
  159.     icon/palette section is where the actual sprite will be displayed
  160.     just as it would be in an actual application.  Beneath the sprite
  161.     will be the sprite mask.
  162.  
  163.       The screen beneath the color palette and to the  left of the
  164.     sprite screen, is the edit screen.  This is where the "blown up"
  165.     version of the sprite will be displayed.  The sprite will be magnified
  166.     to it largest possible size in this window to allow for detailed
  167.     editing of the image.  If a sprite has been defined, a white rectangle
  168.     will show the boundaries of the sprite.
  169.  
  170.       The fourth window is at the bottom of the screen.  This is the
  171.     message window.  All messages will be displayed in this window.
  172.  
  173.  
  174.     COMMANDS:
  175.  
  176.  
  177.       Commands are given by clicking the mouse on the appropriate
  178.     command icon at the top of the screen.  Certain messages will be
  179.     outputted in the message window.  Look at this window periodically
  180.     since some messages are displayed for awhile and then disappear without
  181.     user intervention.
  182.  
  183.       EXIT:  Causes Sprite Maker to do an orderly exit.
  184.  
  185.       LOAD:  Loads a previously saved sprite.  ( The only sprites
  186.          included in this archive which can be loaded are the
  187.          icon sprites listed in the file list.)  When this icon
  188.          is clicked, you will be prompted to enter a file name
  189.          in the message window.  any path/file name may be given
  190.          as long as it is less than 25 chars long terminated by
  191.          a CR.
  192.  
  193.       SAVE:  Save the current sprite to a file. ( A sprite must be
  194.          defined first.)  You will be prompted for a file name
  195.          in the message window.  Any path/file name may be given
  196.          which is less than 25 chars terminated by CR.
  197.  
  198.     CREATE:  This option is used to begin a new editing session.
  199.          when this icon is clicked, an X/Y scale is displayed in
  200.          the edit window, along with two rectangles in the sprite
  201.          window.  These rectangles represent the size of the new
  202.          sprite.  Use the mouse to adjust the rectangles to the
  203.          size of the sprite you wish to create.  The scale in the
  204.          edit window is in pixels.  Once you have the rectangle
  205.          equal to the sprite size, click the right button to
  206.          create that size sprite.  This must be done to create a new
  207.          sprite.  If a sprite is already current, you will be
  208.          asked if you want to destroy the current sprite.
  209.  
  210.      FILL:   This option will fill a bounded area with the selected
  211.          color.   The boundaries can be of different colors.   Once
  212.          clicked, you will be prompted to click in the area which
  213.          you wish to fill,  once clicked, the function will replace
  214.          all pixels with the same color as the one clicked within a
  215.          bounded area.
  216.  
  217.       FLIP:  This will flip the sprite upsidedown.
  218.  
  219.       FLOP:  Flops the sprite over (mirror image)
  220.  
  221.     ROTATE:  Rotates the sprite 90 degrees counterclockwise.
  222.  
  223.     CIRCLE:  Will draw a circle.  you are prompted to click on the
  224.          center point and then the outter point which determines
  225.          the radius.   Sprite Maker will then draw a circle
  226.          of that radius.
  227.  
  228.       LINE:  Draws a line between two points.  You are prompted to
  229.          click on a start point, then a stop point.  Sprite Maker
  230.          then draws a line between the two points.
  231.  
  232.     BORDER:  Outlines the sprite.  Border fills the pixels surrounding
  233.          the borders of the sprite with the chosen color.
  234.  
  235.       RECT:  Draws a rectangle given two opposite corners of the
  236.          rectangle.  You are prompted to click on the first
  237.          corner then the second.
  238.  
  239.  
  240.  
  241.     CHOOSING A COLOR:
  242.  
  243.       To choose drawing colors, simply move the mouse to the color
  244.       you wish to use and click any mouse button.  Notice the "selected
  245.       color" block to the right of the palette change to the newly selected
  246.       color.  This verifys that the new color has been selected.
  247.  
  248.  
  249.     EDITING A SPRITE:
  250.  
  251.       Once you have defined the sprite by either loading a previously
  252.       saved sprite, or by creating a new one using CREATE,  you can draw
  253.       by choosing a color then moving the mouse to the edit window and
  254.       press the left mouse button.  Pixels will be drawn with the selected
  255.       color at the current mouse position/s.  Hold the button down to draw
  256.       continuously, or press then release the button to plot a pixel.
  257.  
  258.       While you are editing the sprite, the mouse is bounded to within
  259.       the bounderies of the sprite.  To exit from this area simply press the
  260.       right mouse button and Sprite Maker will put you into the palette.
  261.       If you just want to choose another color and go back to editing,
  262.       put the mouse on the desired color, and hit the left button.  If you
  263.       wish to quit editng, press the right button.
  264.  
  265. ******************************************************************************